home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / networking / misc / sana2.lha / sana2 / examples / readme
Encoding:
Text File  |  1991-11-18  |  2.1 KB  |  47 lines
  1. $Id: readme,v 1.3 91/11/13 10:09:29 dlarson Exp $
  2.  
  3. These are utilties for use with SANA-II drivers.  Some may be useful to
  4. advanced end-users (with some additional work) but all should be useful to
  5. SANA-II developers.  The source code to these utilities should provide good
  6. examples of how to use much of the functionality within the standard, and the
  7. behavior of the utilities should help to test new driver implementations.
  8.  
  9. Most of the utilities take advantage of skeleton.c and skeleton.h which
  10. include functions for opening and closing a SANA-II device.  Notably, these
  11. functions read the device to open and the unit number to open from the
  12. environment variables SANA.Device and SANA.Unit if those enviroment variables
  13. exist, else the user is queried.
  14.  
  15. None of the utilities are optimized in any way and all could be made much
  16. smaller, but they probably do not warrant any time for any optimizations, at
  17. least not at this time.
  18.  
  19. If any of these are ever made into end-user utilities, they should be Amigaized
  20. (readargs, no printf(), more reasonable  version
  21. numbers, etc.  As it is, they are tiny and source would be included in any
  22. distribution anyway.  (OK, maybe that's still not a good excuse.)
  23.  
  24. devquery -- gives information about the device.
  25.  
  26. configure -- configure a SANA-II device.  This can only be succesfully done
  27. once, but must be done before the SANA-II device is used for anything other
  28. than devquery.  This program accepts as an argument a user-override for the
  29. hardware address (though not all devices will respond to this "override").
  30.  
  31. globstats -- print global statistics from the SANA-II device.
  32.  
  33. typestats -- ask SANA-II device to keep statistics on a particular type of
  34. packet and print said statistics gathered by the device.  It defaults to
  35. gathering ten seconds of statistics, but a command line argument may change
  36. this default.
  37.  
  38. waitforonline -- wait until a SANA-II device comes online.  Really just for
  39. testing this functionality in a driver.
  40.  
  41. online -- put an offline SANA-II device online.  Really just for
  42. testing this functionality in a driver.
  43.  
  44. offline -- put an online SANA-II device offline.  Really just for
  45. testing this functionality in a driver.
  46.  
  47.